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а ь 
> № АР! @ехатр/е-ар! 
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[аа] 
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У Г АдаттКа 
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зфатс РипсёТоп сгеажеСпаппе1ВуМате($+г1пд Фпате) {4 
$рао = пем РОО\Спаппе1РО0(); 
$рао->пате = Фпате; 
$рао->сгеа{е_+1те = +1те(); 
5е1+: :1пзег{ТоСпаппе1 $Таб1е($рао); 


зфаетс Рипсетоп ада/зегТоСпаппе1 (1п{ Физег_14, тие $сйаппе1_19а) 


| $и$е а 
\ОВ\Му5а1Адарког: :1п5ег+ТоГоазТаБТе("мпуеуег, изег_14=0"); 


[пмодиШе] гезиеа то изе ОВ\Муза!Адартог, #'$ ицегпа! т @аь : 


с1а$$ Муза1Адар+ог \ОВ\Му5а1Ааареог 
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$с Матезрасе: \ЭВ\ 


.../згс/ОВ/Му$оАдартог.рпр 


Зоигсе: 
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Ри АА 
| ра ^ у 
ИЖ ' 
ИАА 


Месси 


Адам 


Месси 


Мез1тидег/ 
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АааттиКка/ 


Адам 


Месси 


Мезтидег/ 
Спаппе1$/ 
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© ЛотМоНЯсаНоп.рИр | 
м $п->5епа($ита); 
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- "\\Ме$зтпдег\\Кегпе1 \\Мо+1 +1 сатопТифегРасе" 
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- "\\Мез$зтпдег\\Кегпе1 \\М5а)ахаразе : :аааЧзегТоСпаппе1 ()" 
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Итого. Модуль — это обычная папка с РНР-кодом. 


С одной стороны, она определяет доступ "внутрь" через ехром. 
С другой, она определяет доступ "наружу" через гедиие$. 
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Модульность позволяет 
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Моаце 


В общем, не найдя аналогов, мы сделали Моди!Ке. 
Мы скрестили наш опыт в ОЕ, чтобы это было удобным. 
Наш опыт в разработке, чтобы это было правильным. 


И наш опыт в компиляторах, чтобы это было быстрым. 
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Создание модуля из папки 


@ @® М№ем/ МодиЩЖе 
Мате: @тезз1-Кегпе| 
ОБезсирИоп: 
ро|аег: 
А То|аег {о расе {Пе п‹ Чи 
Матезрасе: 
Вазе патезрасе Гог {Пе тодиЩе 
Ехрощеа 5утбо!|$ 


м“ 


Меззтадек\ 
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м“ 
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РОО\ 


(© Сваппе! 


РОО 
[е.: Ь/с, 1 
+ +Не 


Сапсе! 


° ок 


Делаем символы ижегпа! и обратно 


® 
с1а$5$ ЗогЕРо11су { ехроцед {гот @тез$1-Ро!4ег$ 
соп5 50К = Сгеме пем РНР Тез > 
соп$Е $50К = Нпа изадез$ т {пе сиггег тодище > 
} 57° Со {о тоаиц Ще аейпоп > 


а@Ртпе(' $0КТ_ВУ_МАМЕ', 2); Имегпа! пм @тез$1-Ро14егз 
деЁтпе( ' $0КТ_ВУ_СО0МТ", 3);  имега! т @те$$1-Ро!4ег$ 


О, ехрог 


ехроцеа 1гот @те$$!-о|4ег$ 


Со {0 МодиЩе Бейт \юп 


Ни{$ зе \тпод$... 


шпхегпа|, если уже используется 


с1а$$ ЗогЕРо1тсу { 


ехроцеа 1гот @те$$1-Го1аег$ 
соп5ф 5ОКТ!@ име 


д МаеметаИо Фтезаовыв >. 
} 


$ро11су = $огЕРо1тсу: : $ОКТ_ВУ_МАМЕ; 


$ро1аег$ = 5$ог+ТтрТетепфа*топ: : 5огЕРо1аег$($Ро1аег$, $ро11су); 


перестанет компилироваться 


шпхегпа|, если уже используется 


с1аз$ ЗогЕРо11су { Ищегпа т @те$$1-фРо!4ег$ (ме Гог \АР\Ар!Мез$тадег::деМуРо!аег$()) 


соп5Е 5ОКТ_ВУ_МАМЕ = ©. 
соп5 5ОКТ_ВУ_ИМКЕАО_СОИМТ = 1; 


$ро11су = Зевфре+еу--509®Р-ВУ-МАМЕ; 


$Ро1аег$ = Зог&Ттр1етепфаетоп: : 5оиЕРо14аег$($Ро1Аег$, $ро11су); 


а11ом-1тпфегпа1-ассе$$: 
"\\АРТ\\АртМе$51пдег: : деЕМуРГо1аег$()": 
- "ЗогЕРОо11су" 


Скрываем члены публичного класса 


@ 
5фаетс Гипсётой 1$)5ег5иб$сгтБеа(ти+ $сПаппе1_14): Боо1 { ехрощеа {гот @те$$1-спаппе!$ 
$а11_5и6$ = Мзадажаразе: : т 


} 


Скрываем члены публичного класса 


® 
$фафтс Рипсётоп 1$)$егп$ибзсгтБеа(Сти+ $сПаппе1_т14а): Боо1 { ехрощеа гот @те$$1-спаппе!$ 
$а11_$и6$ = Мзадажаразе:: т 


} 


фогсе-тифегпа1 : 


- "Спаппе1Асетоп$: :1$)5еп$ир$сгтреа()" 


Новый код и геаиге 


фипс&топ $епа(Стиф $изег_та) { 
91ора1 $раг5еа_зе551оп; 


[поди е] гези«еча {о изе д!ора! $рагзе4_5е5$1юп, Ц'$ по{ гедииеа Бу @те$$1-сваппе|$ 


Ааа зутБо! {0 гедииез хФ< Моге асйоп$... \№® ^^. \<ХЕЛО 


Новый код и геаиге 


7 ПЛерепаепсте<‹ , реп 
| д 29 № т Гу. Е <. г д уу |] 


7 о{а|, сИскК {о гедепега{е 
гедитге: 
2 тоачцЩе$ 
- "@арт" 
- "@и5ег5" 
1 с1а$$ 
- "\\Меззтипдег\\Кегпе1 \\М№о{1 1 сафтопТифегТасе" 
2 те{оа$ 
- "\\Мез$зтпдег\\Кегпе1 \\М5арахаразе: : аааЧзегТоСпаппе1 ()" 
- "\\Меззтидег\\Кегпе1 \\М$даВафаразе : : де*Спаппе1 $01И5$ег()" 


1 псйоп 
- "\\сиггей{И$ег()" 


1 ч1оБа! хапаЫе 


- "$о1оБа1_маг" 


Новый код и геаиге 
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7 1о{а|, сИскК {о гедепегае 
гедитге: 

2 тодиЩе$ 
- "@арт" 
- "@и5ег5" 


1 с1а$$ 
- "\\Мез$зтпдег\\Кегпе1 \\М№оЕ1 1 сатопТифегРасе" 


2 тео4$ 
- "\\Мез$5тпдег\\Кегпе1 \\М5а)ааразе : : аааЧзегТоСпаппе1 ()" 
- "\\Меззтипдег\\Кегпе1 \\М$аВафаразе : : де*Спаппе1 $01И5$ег()" 


1 псйоп 
- "\\сиггей{И$ег()" 


1 ч1оБа! хапаЫе 


- "$о1оБа1_маг" 


Новый код и геаиге 


5 {оа|, сИск то гедепегае 
гедитге: 

3 тодцШез$ 

- "@арт" 

- "@те$$1-Кегпе1" 

- "@изег5" 

1 ТупсЧоп 

"\\сиггейИ$ег()" 


1 чоба| уайаЫе 


"Фа1оБа1_маг" 


Новый код и геаиге 


1 с1а$$ 


ии | м | 
СИ 192" | мворавБазенаачувегТоСваппе(! $изег_14, /7Ё $сПаппе!_14): уса 


@2 пе{по4$ х/ 


\ 


19 - "\\Меззтипдег\\Кегпе1 \\М$аВафаразе: : ааа) ег урСпаппе! () ы 
- "\\Меззтипдег\\Кегпе1 \\М$аВахаразе : : де=Спаппе1 $01И5ег()" 


Вложенные модули, подмодули 


Ме1пдег/ 
СПаппе1$/ @те$ $1 -сПаппе1 $ 
Ео1аег$/ @те$$1-фо1аег$ 


Кегие] / @те$$1-Кегие] 


Вложенные модули, подмодули 


Ме551пдег/ Мез1ипдег/ @те$$1 
СПаппе1 $/ @те$$1-сПЙаппе1 $ СПаппе1 $/ @те$$1/сЙаппе1 $ 


Ео1аег$/ @те$$1-фо1аег$ Ео1аег$/ @те$$1/Ро|1аег$ 


Кегие1 / @те$$1-Кегпе1 Кегие1 / @те$$1/Кегие] (тифегиаТ) 


Мате: 


№ ем Моди Же 
| @тез$1 
Безсирйоп: 
ро|аег: 
Матезрасе: 


Ехрощеа З$утбо!$ 


Вазе патезрасе ог {Пе тодиЩе 


Вложенные модули, подмодули 


— _ Мемеа тодиЙе$ 


У ©® отез$1-сваппе!$ 


У ©® @тез$1-юЮаег$ 
® @тез$-Кегпе! 


Сапсе! 


Вложенные модули, подмодули 


7 {о{а|, сйскК фо гедепегае 
гедитге: 

4 тоаицЩе$ 

- "@те$$1/сйаппе1 $" 


- "@теззт/Ро1аег$" 


1 
‚© 
ф 
п 
п 
ме". 
< 
А 
Ф 
Е 
5 
ф 
Е 


ИИА 


" 


[тои Же] гезищеа {о изе @те$$/Кеге!, ('$ нщегпа! т @те$$1 : 


З исчо! 


Ета изагез$ внутри модуля 


3 тоацез сиггейИ5ег 
ы 33 Ведепегае Модше Ведигез ® Зпом СощехЕ АсНоп$ 
- "@тез51/сПаппе1 $ в ьв —= п11 >) 
, ‚„ ® пом Сомех{ АсНоп$ = р Н 
- "@тез$51/Ро1аег$ пем Цпаи+По Рае 
- "@исегс" @ Раме У Сору / Рае Зресиа! 
Е ОЕ Сору / Рае 5реза! > Физег; Соитп Зеесйоп Моае 


"\\адат1пка_ааац Соитп З@есйоп Моае па 032065 


"\\адаттика_сгеа [па Узаде$ в _ АП Узадез т @арй  — 
осетия РИ Ивадез п Модиие..: 


Ета Чзадез$ т МодиШе... 


Зависимость от чужого модуля 


3 Ведепегае Модше Ведитез 


® Зном СомехЕ АсНоп$ > 

Д {о{а|, сйск {о гедепега{ 
гедитге: О Разе 3\ 
Сору / Рае Зреса! > 


3 тодицЩез$ 
м Соитп З@есйоп Моае 
- '@арт 

- "@и5ег5" Ета Узадез №1 


Зависимость от чужого модуля 


® ® МодиЩе @те$$!/Кегпе! $утБо]$ 


БочЫе-сйскК оп утро! {о $По\м/ ($ изаде$ тм @те$$/спаппе[$: 
“ Меззтдей 
У“ Кете!й\ 
9 
(© МоНйсаНопи\егасе 
У РОО\ 
о 
о 


Сапсе! 


Имена модулей в интерфейсе 


$фафтс Кипсфтоп сгеафейего(): зе1Р { ехрощеча гот @.../рао 


гефиги пем зе1ф; 


} 


$фафтс Кипсётой сгеа+ейего(): зе1ф { ео 


гефиги пем зе1ф; 


} 


Имена модулей в интерфейсе 


топой › Меззтаег (@теззтаег) › Кегпе! (@.../кегпе!) › РОО (@.../р4о) © МеззадеРРО.рпр © МеззадеРРО 


У В: Меззтадег 
У №: Сваппе!$ 
У и МоНйЯсаНоп$ 
© ]отМо{йЯсаНоп.рНр 
(© теауеМоНЯсаНоп.рНр 
№ тодие.уат! 
© Сваппе!АсНоп$.рНр 
> №" Ро|аег$ 
У №" Кете! 
у №РоО 
№ поаиИе.уат! 
© СпаппеРРО.рНр 


Плагин — это удобный Ч над конфигом .тодиЩе.уап"|. 


Именно файлик хранится под гитом, именно изменения в нём 
видны на ревью при добавлении зависимостей или исключений. 


пате: "@тоан1т1т+е-пате" 
езсгтртоп: "..." 
патезрасе: "5$оте\\Матезрасе\\" 


ехрогт: 
- "СТаз$ТиМатезрасе" 
- "ОгСопсге*е: :; СГА$$_МЕМВЕК" 
апа офПег$ 


фогсе-тифегиа1 : 
- "СТа$5ТиМатезрасе : : а 1сМежйоаС)" 
апа офПег$ 


геаитге: 
- "@апо%пег-тоан1т1+е" 
- "#сотрозег/раскаде" 
- "\\оТора1СТа$5" 
апа офПег$ 


а11ом-тифегпа1-ассе$$: 
"@грс": 
- "СТа$5А ТТ омедЕогКрсМоачн1Те" 
- "ОгСопсге*е: :тефпоа()" 
апа офПег$ 


Моацнке 


=> 


исключения 


@те$$1-Кегие1 адаттпка_ааа)ег(.) 


Ма бакаразе — 


ОВ 
= 
А] 


мА | 
ТУ 


Не предусмотрел? 
Забыл ехром? 
Или согпег са$е? 


Кегие1/ .тоди1т+е .уат1 


а11ом-тифегпа1-ассе$$: 
"\\адаттика_аааУзег()": 
- "МзаОафара$е: :1и5ег05ег()" 
- "МзаПатжаразе : : ТАВЕЕ_МЕЗЪАСЕЗ" 


@те$$1-Кегие1 адаттпка_ааа)ег(.) 


МзаПафаразе =—_ 


Именно благодаря конфигу работают проверки 
во время компиляции, в СК-хуках и в Театску: 
Поскольку есть инструменты, анализирующие конфиг. 


МоацнкКе 


== 


РНР5хкап 


Моаике + РНР$5хап 


Сделали плагин для Ореп 5оигсе сообщества 
Парсит уап!-файлы, валидирует, резолвит через рефлексию 


Проверяет модульность по тем же самым правилам 


Моаике + РНР$5хап 


Не удалось пока победить РНРУ%ап-кэш, т.к. рпр-файлы не меняются 


Если ошибки выглядят старыми, сброс кэша помогает всегда 


Моаике + РНР$5хап 


[моач11{е] гезфгтсфеа фо са11 Ме$$1пдег\Кегие1 \М$аахаразе : : ааа/зегТоСпаппе1(), @те$$1/Кегпе] 1$ тифегпа1 1п @те$$1 
[моач114е] гезфгтсфеа фо изе Мез51пдег\Спаппе1 $\Мо{1 #1 са топ$\отпСПаппе1Мо{1+1са топ, 14'$ тифегиа1 1п @тез$1/сПаппе1 $ 


МоаинкКе 


== 


КРНР 


МоаицКе + КРНР 


Изначальная, эталонная версия, встроена в КРНР 
Нет проблем с кэшем, т.к. КРНР анализирует проект целиком 


Используется в УКСОМ 


МоаицКе + КРНР 


СотртТафтоп еггог а $+$аде: Спеск Фипс са11$ апа уагагд, деп Бу тоаи11+е-спеск-гиТе$.срр:327 
Аааттика/адаттика.рир:9 тп адатика_аааЦзег 
Мзабатаразе : : ааа /зегТоСпаппе1 ($изег_1та, $спаппе1_14а); 


[моаи11+е] гезфгтсфей +о са11 Ме$$1пдег\Кегпе1\М$абатаразе : : ааа /зегТоСПаппе1()), @те$$1/Кегпе] 1$ 1пфегпа1 1п @те$$1 


Сотрт1атойп еггог а $%аде: Среск Фипс са11$ апа уагагд, деп Бу тодаи11{е-спеск-гиТе$.срр:318 
Ме5$1пдег/Кегпе1 /Мадафаразе.рИр:36 1п М$абатаразе: : ааа /зегТоСпаппе1 
\ОВ\Муза1Адартог: :1пзегЕТогод$Таб1е("мпуеуег, изег_14=0"); 


[моаи11+е] гез+гтсфей +о са11 ОВ\Му$а1Адарфхог : :1пзегЕТогод$ТаЛе(), 14'$ тпфегпа! 1п @а6 


КРНР 


В КРНР встроена полная 
поддержка МодиКе. Он читает 
уагт|-файлики и проверяет код на 
все правила. 


СТи 2К ПоокК$з 


На препуше гоняется КРНР, так 
что пройдут все проверки. А если 
пушнуть в обход, то при сборке 
уж точно свалится. 


поменфу 


В наш линтер Моди\е не 
встроен, т.к. это несовместимо с 
ЧЙ-режимом. Да и не нужно: у 
нас везде КРНР. 


РНРЫкогт 


В РНРЫогт все проверки 
выполняются этим плагином. Он 
автоматически генерит конфиги 
и показывает ошибки. 


РНР 5хап 


Для сообщества мы сделали 
РНР\ап-плагин. Это позволяет 
использовать Модие и в 
обычных РНР-проектах. 


Другие ТОЕ 


Для других РЕ плагинов нет. Я 
не понимаю, как можно 
разрабатывать большие 
проекты, сидя в М. 


МодиШе удобно использовать не только в монолите. 


А например, разрабатывая любой Сотрозег-пакет: 
почему бы не писать его внутренности модульными? 


Моацнке 


в 


Сотрозег 


\м01се-фех+ 


Герасим мотсе-+ех+ 


1тр1/ — @1тр| 


Ето) 1 Таб1е.рир 


ТехЕТо5реесй .рир 
Тгап$|1%$егаетоп .рир 


Сотрозег-пакет — обычный проект 


У Шзс сТазз Не1рег$ { ехрощед гот @Итр! 
У ВЕ тр фас ФипсёТоп $+&г1рЕто)1($4г1пд $$) { ехромед тот @итр! 
М точииелуати! $°утро1$ = ргед_$р114С'//и', $$); 
ии $по+*_ето)]1 = аггау_+114ег($зутБо1$, 
© Техтозреесн.рпр Рп($с) => !1п_аггау($с, Ето)тТаТе: : МАТТУЕ_ЕМО-7Т_1Т5$Т) 
© ТгапзШегаНоп.рИр 2; 
© Мауемширйег.рвр гефигп 1трТоае('', $по+_ето)т); 
> № уепадог 


&} сотрозег.]зоп 


АнатоКесодит топ 


укК/мотсе-фех+ 


Подключение в монолит 


2 {о{а|, сИск {о гедепегае 
гедитге: 

1 тоаие 

- "@те$$1/Кегпе1" 


1 сотрозег расКаде 


'#уК/мотсе-+ех+" 


Подключение в монолит 


2 {оа|, сйск {о гедепегае 
гедитге: 
1 тоаце 


- "@теззт/Кегпе1 " 
1 сотро$ег расКаде 
- "#УКк/уотсе-тех{" 


Неявный модуль #уК/мотсе-фех+ 


#уК/мотсе-фехе/@1тр1 


Проверки работают автоматически 


о О О О О А А О О О А о о о о о о от о ый 


Сотрт1Тафттой еггог а $%аде: Тлие ае пез ра$$, деп Бу тоди11+е-сйеск-ги|е$. срр: 318 
Мез51пдег/Спаппе1 $/СПаппе1Асетопт$ .рИр:31 тп СПаппе1Асетоп$: :1еауе 
\УК\\Мот сеТех+\1тр1\Ето)1Та Ле: : МАТТУЕ_ЕМОЗТ_ЕТФТ; 


[моди11+е] гез+гтсфей фо изе УК\МотсеТехЕ\1тр1\Ето)1ТаБЛе, 1+4'$ тифегпа| тп #УК/уотсе-+ех{/@1тр1 


ИА 
> 

И * | 

И} 


Явные ехрог* 
у Сотрозег-пакета 


#уКк/мотсе-+ех+ аааттпка_ааа9/зег(.) 


СТаз$ Тгап$11$егаетоп и 


{рго]есЕКоо{}/ .тоаи1т*е . уат1 


пате: "<сотрозег_гоо+ф>" 
патезрасе: "\УК\\\МотсеТех&\\" 


ехронЕ: 
- "ТехеТо5реесй" 
- "МамеМи1 тр] тег" 
# - "@ттр1Т" 


фогсе-ти+егпа1 : 
# тоже работает 


гедитге: 
# оставляем пустым, генерится из сотро$ег. ] 50п 


‚тоачЖе.уат| + сотрозег.|зоп 


У Ш5гс с1а$5$ Тгап$11+$егаетоп {  И\егпа| м <сотрозег_гоо{> 
> МЕтр! $фафтс КРипсе Топ гиз$ТоТгап$11+(С$+г1па $$) {  Имета|т <сотрозе! 
© ТехПоЗреесв.рНр Те 9 
© ТгапзШега{Ноп.рНр 
© М/ауемир!ег.рпр 
> № уепаог 
№ тоашКе.уат! 


У, 


гефиги ^ 
гефиги ттр1Т\Не|регз : : {гап$11ЕСоп$1таегтпа5оипа$($$); 


#уКк/мотсе-+ех+ аааттпка_ааа9/зег(.) 


СТаз$ Тгап$11$егаетоп — 


(тифегпаТ)) 


Сотрозег-пакет с точки зрения МодиЩе 


ничем не отличается от обычного проекта. 
А внутри монолита пакет становится неявным модулем. 


МоацнкКе 


== 


ЭТИМОЛОГИЯ 


модуль 
| 
монолит 


модуль 
+ модулит 
МОНОЛИТ 


модуль 
+ модулит = тоаи!*е 
МОНОЛИТ 


модуль моде 
+ модулит = тоаи!*е - 
монолит се 


] 1 ^^ ыЬк 
не [> 


Г@\ 


® 
У. 


Ир : //дтЕПиьЬ . сот/УКСОМИтоаи1 т {е 


| Обратная связь 


< 


№ | комментари 
'докладуп по ссылке. 
| |\\ 


`Александр Кироаное! 


| ан Команды КРНР 


| 
| 
] | \ 
| | АХ \ | 
| ] | в \ \ | 
/ И | | | АХ \ \ \ | 
] у | | | | ] | ] ] | | \ \ \ \ \ | | 
| И у / | | | | | ох | \ \ | | 
] ] \ \ || 
| | й | | | | \ \ | | 


РИр/^ РНР! Вова 


У“ 1 2022 | 


